home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat5 / pmlaunch.z / pmlaunch
Encoding:
Text File  |  2001-04-17  |  22.1 KB  |  463 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))                                                        PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmllllaaaauuuunnnncccchhhh - metric specification and scripts for launching other tools
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h._c_o_m_m_o_n
  13.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c
  14.      $_H_O_M_E/._p_c_p/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      This page describes a metrics specification format and a set of scripts
  18.      that can be used by tools to facilitate launching, and being launched by,
  19.      other tools which have no knowledge of each other.
  20.  
  21.      The intended use is for performance tools that are part of, or associated
  22.      with, Performance Co-Pilot (PCP).
  23.  
  24.      A script for the target tool parses the metrics specification and
  25.      generates command line options and/or configuration files for the
  26.      appropriate metrics.  For example, ppppmmmmvvvviiiieeeewwww(1) will use the same metrics
  27.      specification when launching tools such as ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmggggssssyyyyssss(1) etc.,
  28.      without any knowledge of how these tools will visualize those metrics.
  29.  
  30. LLLLAAAAUUUUNNNNCCCCHHHH MMMMEEEENNNNUUUUSSSS
  31.      The launch menu of tools which support the ppppmmmmllllaaaauuuunnnncccchhhh metrics specification
  32.      can be configured to include any selection of IRIX, PCP or other tools.
  33.  
  34.      The launching tool will search /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c and
  35.      $_H_O_M_E/._p_c_p/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c for a list of tools that can be launched.
  36.      The first line of the file specifies the version of ppppmmmmllllaaaauuuunnnncccchhhh that this
  37.      file conforms to. The following lines should contain the menu button name
  38.      followed by the path to a launching script or program, including any
  39.      arguments.
  40.  
  41.      For example, the default /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c will
  42.      contain:
  43.  
  44.           pmlaunch Version 2.0
  45.  
  46.           dkvis           _pmview_frontend dkvis
  47.           mpvis           _pmview_frontend mpvis
  48.           nfsvis          _pmview_frontend nfsvis
  49.           pmchart         _pmchart
  50.           pmgsys          _pmgadgets_frontend pmgsys
  51.           pmkstat         _pmkstat
  52.           pmval           _pmval
  53.  
  54.      Empty lines and lines which begin with a ``#'' are ignored.
  55.  
  56.      Menu items with identical names in the second _p_m_l_a_u_n_c_h_r_c file will
  57.      replace the corresponding entries in the first file.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))                                                        PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))
  71.  
  72.  
  73.  
  74.      The launching tool will search for the launching script in the directory
  75.      specified in the environment variable PPPPMMMM____LLLLAAAAUUUUNNNNCCCCHHHH____PPPPAAAATTTTHHHH, or
  76.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h if it is not set.
  77.  
  78.      For example, the launch menu of ppppmmmmvvvviiiieeeewwww(1) will contain the entries _d_k_v_i_s,
  79.      _m_p_v_i_s, _n_f_s_v_i_s, _p_m_c_h_a_r_t, _p_m_g_s_y_s, _p_m_k_s_t_a_t and _p_m_v_a_l.  If a user selects
  80.      _n_f_s_v_i_s, the script __p_m_v_i_e_w__f_r_o_n_t_e_n_d is executed with the argument _n_f_s_v_i_s.
  81.  
  82.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c is automatically updated by PCP
  83.      products as new tools become available using the script
  84.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_m_k._r_c.
  85.  
  86.      The remainder of this man page describes the metrics specification
  87.      format, and the shell procedures that are provided for extracting the
  88.      relevant information to build a launching script for any tool.
  89.  
  90. MMMMEEEETTTTRRRRIIIICCCCSSSS SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN FFFFOOOORRRRMMMMAAAATTTT
  91.      The metrics specification which is generated by the launching tool
  92.      contains the minimal information required to display information related
  93.      to the source, domain, color, visual and value semantics, scale and
  94.      groupings of a collection of performance metrics.
  95.  
  96.      To manage later configuration file revisions, the first line of the
  97.      configuration file should be
  98.  
  99.           pmlaunch Version 2.0
  100.  
  101.      All empty lines, or lines beginning with a ``#'' are ignored. A newline
  102.      character separates each statement.
  103.  
  104.      To permit tools to convey update intervals, and other PCP specific
  105.      information, a set of options may be specified with the syntax:
  106.  
  107.           option _v_a_r_i_a_b_l_e=_s_t_r_i_n_g
  108.  
  109.      Any _v_a_r_i_a_b_l_es that are specified are converted to shell variables by the
  110.      shell procedure llllaaaauuuunnnncccchhhh____vvvvaaaarrrr.  The following _v_a_r_i_a_b_l_es are commonly used
  111.      between PCP tools, and should have values that may be used in the
  112.      corresponding command line argument. An option without a value is
  113.      equivalent to not setting the variable.
  114.  
  115.      ddddeeeebbbbuuuugggg  The current debugging flag used by the launching tool which is
  116.             passed to the target tool as a command line option.  Therefore,
  117.             valid values should be a combination of flags identified by
  118.             ppppmmmmddddbbbbgggg(1).  Usually associated with a ----DDDD option to PCP tools.
  119.  
  120.      nnnnaaaammmmeeeessssppppaaaacccceeee
  121.             The PCP namespace used by the launching tool.  Usually associated
  122.             with a ----nnnn option to PCP tools.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))                                                        PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))
  137.  
  138.  
  139.  
  140.      ttttiiiimmmmeeeeppppoooorrrrtttt
  141.             The identification of the port used for the time controls (see
  142.             ppppmmmmttttiiiimmmmeeee(1)).  Usually associated with a ----pppp option to PCP tools that
  143.             use ppppmmmmttttiiiimmmmeeee(1).
  144.  
  145.      ssssttttaaaarrrrttttttttiiiimmmmeeee
  146.             The starting time of the application in the currently fetched
  147.             contexts. In most cases, this will be the current time on the
  148.             host/s in live mode, or in the archive/s.  See PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for a
  149.             description of time formats.  Usually associated with a ----SSSS option
  150.             to PCP tools.
  151.  
  152.      eeeennnnddddttttiiiimmmmeeee
  153.             The finishing time of the application.  This is normally only used
  154.             with archives. See PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for a description of time formats.
  155.             Usually associated with a ----TTTT option to PCP tools.
  156.  
  157.      ooooffffffffsssseeeetttt The starting time as an offset from the ssssttttaaaarrrrttttttttiiiimmmmeeee.  See
  158.             PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) for a description of time formats.  Usually associated
  159.             with a ----OOOO option to PCP tools.
  160.  
  161.      iiiinnnntttteeeerrrrvvvvaaaallll
  162.             The update interval of the launching application in seconds.
  163.             Usually associated with a ----tttt option to PCP tools.
  164.  
  165.      pppprrrrooooggggnnnnaaaammmmeeee
  166.             The name of the launching tool.
  167.  
  168.      ppppiiiidddd    The process ID of the launching tool.
  169.  
  170.      sssseeeelllleeeecccctttteeeedddd
  171.             The metrics are based on a selection in the launching tool if this
  172.             is set to ttttrrrruuuueeee.
  173.  
  174.      ttttiiiimmmmeeeezzzzoooonnnneeee
  175.             The timezone currently in use by the launching tool.
  176.  
  177.      ddddeeeeffffssssoooouuuurrrrcccceeeettttyyyyppppeeee
  178.             The type of the default metrics source in use by the launching
  179.             tool (either hhhh or aaaa).
  180.  
  181.      ddddeeeeffffssssoooouuuurrrrcccceeeennnnaaaammmmeeee
  182.             The name of the default metrics source in use by the launching
  183.             tool (i.e. the name of a host or an archive).  Usually associated
  184.             with either the ----aaaa or ----hhhh options to PCP tools.
  185.  
  186.      The launching scripts for a particular application have the option to use
  187.      or ignore these variables as required.
  188.  
  189.      The target PCP and IRIX tools may be static or dynamically configurable.
  190.      Therefore, a reasonable amount of information about each metric is
  191.      required in the metrics specification so that all possible launching
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))                                                        PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))
  203.  
  204.  
  205.  
  206.      scripts can extract what they require.  A metric specification must be of
  207.      this format:
  208.  
  209.           mmmmeeeettttrrrriiiicccc _m_e_t_r_i_c__i_d _g_r_o_u_p__i_d _g_r_o_u_p__h_i_n_t _c_o_n_t_e_x_t _s_o_u_r_c_e _h_o_s_t__i_n_f_o
  210.           _n_a_m_e _c_o_l_o_r__s_p_e_c _t_y_p_e _s_e_m_a_n_t_i_c_s _s_c_a_l_e _d_i_m_e_n_s_i_o_n _i_n_d_o_m [[[[_i_n_s_t_a_n_c_e]]]]
  211.  
  212.      The _m_e_t_r_i_c__i_d uniquely identifies the metric within the configuration
  213.      file, so an error is generated if another metric has the same number.
  214.      Ideally, the metric's internal PMID should be used, but is not required
  215.      (see PPPPCCCCPPPPIIIInnnnttttrrrroooo(1)).
  216.  
  217.      Metrics with the same _g_r_o_u_p__i_d should, where possible, be visualized
  218.      together.  The _g_r_o_u_p__h_i_n_t gives a hint as to how they should be
  219.      visualized.  Hints which could be given include:
  220.  
  221.      nnnnoooonnnneeee   Indicates that there is no appropriate hint.
  222.  
  223.      ppppooooiiiinnnntttt  Each metric has its own plot.  For example, a line in ppppmmmmcccchhhhaaaarrrrtttt(1).
  224.  
  225.      ssssttttaaaacccckkkk  The metrics are stacked in a bar plot.
  226.  
  227.      uuuuttttiiiillll   The metrics are stacked in a utilization plot which is always
  228.             scaled to 100%.
  229.  
  230.      The metric _c_o_n_t_e_x_t may have one of two values, ``hhhh'' or ``aaaa'' indicating
  231.      either a host or an archive. The host or archive should be specified in
  232.      the _s_o_u_r_c_e.  The _h_o_s_t__i_n_f_o for an archive should be the target host of
  233.      the archive.  The _h_o_s_t__i_n_f_o for a host should indicate with the value
  234.      ttttrrrruuuueeee that the host must be reached using ppppmmmmssssoooocccckkkkssss(1).
  235.  
  236.      The _n_a_m_e contains the name of the metric, not including any sources or
  237.      instances.
  238.  
  239.      The _c_o_l_o_r__s_p_e_c is used to describe not only the color of the metric, but
  240.      also any scaling that was applied.  A _c_o_l_o_r__s_p_e_c must be of one of the
  241.      following formats:
  242.  
  243.           SSSS _c_o_l_o_r,,,,_s_c_a_l_e
  244.           DDDD _c_o_l_o_r,,,,_m_a_x_i_m_u_m,,,,_c_o_l_o_r,,,,_m_a_x_i_m_u_m...
  245.  
  246.      A _c_o_l_o_r__s_p_e_c prefixed with a ``SSSS'' is a static color definition which
  247.      contains only one color and _s_c_a_l_e.  This should be used to describe a
  248.      metric which has a fixed color, regardless of its value.  A _c_o_l_o_r__s_p_e_c
  249.      with a dynamic color scale is prefixed with a ``DDDD'' character, and will
  250.      change to the next color in the list when the _m_a_x_i_m_u_m value is exceeded.
  251.      The _c_o_l_o_rs may be specified by name or with the XXXX(1) rrrrggggbbbbiiii tuple of three
  252.      normalized floats.
  253.  
  254.      The metric _t_y_p_e and _s_e_m_a_n_t_i_c_s fields have single numeric values which
  255.      respectively map to the PPPPMMMM____TTTTYYYYPPPPEEEE and PPPPMMMM____SSSSEEEEMMMM definitions in
  256.      /_u_s_r/_i_n_c_l_u_d_e/_p_c_p/_p_m_a_p_i._h.  The _s_c_a_l_e field comprises three numeric values
  257.      for each of Space, Time, and Count.  These fields are extensions to the
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))                                                        PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))
  269.  
  270.  
  271.  
  272.      ppppmmmmllllaaaauuuunnnncccchhhh version 1.0 format (the current version is 2.0).  Refer to
  273.      PPPPMMMMAAAAPPPPIIII(3) for detailed descriptions of each of the possible values for
  274.      these fields.
  275.  
  276.      The metric _d_i_m_e_n_s_i_o_ns and internal instance domain identifier (_i_n_d_o_m) are
  277.      described in PPPPMMMMAAAAPPPPIIII(3).  The _d_i_m_e_n_s_i_o_n consists of three space-separated
  278.      signed integer values representing Space, Time, and Count respectively.
  279.  
  280.      The _i_n_d_o_m is a single integer.  A metric which does not have an instance
  281.      domain should specify an instance domain of ``----''.
  282.  
  283.      The last field in a metric specification is an _i_n_s_t_a_n_c_e.  As the _i_n_s_t_a_n_c_e
  284.      may contain most characters, including spaces, the _i_n_s_t_a_n_c_e must be
  285.      enclosed in square brackets.  If a metric does not have an instance, then
  286.      the _i_n_s_t_a_n_c_e should simply be ``[[[[]]]]''.  Only one _i_n_s_t_a_n_c_e may be
  287.      specified, so multiple instances must be listed as separate metrics on
  288.      subsequent lines in the metrics specification file.
  289.  
  290. EEEEXXXXAAAAMMMMPPPPLLLLEEEE CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEE
  291.      The following text is an example of the possible output generated by
  292.      mmmmppppvvvviiiissss(1):
  293.  
  294.           pmlaunch Version 2.0
  295.  
  296.           metric 0 0 point h omen false kernel.percpu.cpu.idle S rgbi:0.000000/0.782569/0.000000,1000.000000 1 1 0 2 0 0 1 0 4194305 [cpu0]
  297.           metric 1 0 point h omen false kernel.percpu.cpu.wait.total S rgbi:0.000000/0.782569/0.779279,1000.000000 1 1 0 2 0 0 1 0 4194305 [cpu0]
  298.           metric 2 0 point h omen false kernel.percpu.cpu.intr S rgbi:0.750547/0.782569/0.000000,1000.000000 1 1 0 2 0 0 1 0 4194305 [cpu0]
  299.           metric 3 0 point h omen false kernel.percpu.cpu.sys S rgbi:0.750547/0.000000/0.000000,1000.000000 1 1 0 2 0 0 1 0 4194305 [cpu0]
  300.           metric 4 0 point h omen false kernel.percpu.cpu.user S rgbi:0.000000/0.000000/0.779279,1000.000000 1 1 0 2 0 0 1 0 4194305 [cpu0]
  301.  
  302.           option interval=2
  303.           option debug=0
  304.           option timeport=/tmp/pmview.a002ct
  305.           option starttime=@Wed Dec 11 10:14:46 1996
  306.           option offset=@Wed Dec 11 10:14:51 1996
  307.           option timezone=EST-11EST-10,91/2:00,301/2:00
  308.           option progname=pmview
  309.           option pid=10809
  310.           option selected=false
  311.  
  312.  
  313. FFFFIIIILLLLEEEESSSS
  314.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h
  315.                              Directory containing the default scripts and
  316.                              configuration files for launching tools.
  317.  
  318.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c
  319.                              List of menu items and the corresponding scripts
  320.                              for the launching tools.
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))                                                        PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))
  335.  
  336.  
  337.  
  338.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h._c_o_m_m_o_n
  339.                              Common shell procedures that can be used for
  340.                              generating command line arguments and
  341.                              configuration files from a ppppmmmmllllaaaauuuunnnncccchhhh metrics
  342.                              specification.
  343.  
  344.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_m_k._r_c
  345.                              Script which builds the pmlaunchrc file from the
  346.                              component *.menu files (during install).
  347.  
  348.      /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/*._m_e_n_u
  349.                              Generic menu specification files which are
  350.                              combined to form the default pmlaunchrc file
  351.                              (during install).
  352.  
  353.      $_H_O_M_E/._p_c_p/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c
  354.                              User configurable list of menu items and the
  355.                              corresponding scripts for the launching tools.
  356.                              These items may override those specified in
  357.                              /_v_a_r/_p_c_p/_c_o_n_f_i_g/_p_m_l_a_u_n_c_h/_p_m_l_a_u_n_c_h_r_c.
  358.  
  359.  
  360. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  361.      The PPPPCCCCPPPP____SSSSTTTTDDDDEEEERRRRRRRR environment variable described in the DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS section
  362.      below is fully documented in the PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) manual page.
  363.  
  364.      Additional trace and debugging information from the scripts that
  365.      ``launch'' one PCP application from another may be gained as follows:
  366.  
  367.      1.  All trace and debug diagnostic information is added to the end of the
  368.          file named in the environment variable PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH____FFFFIIIILLLLEEEE (or ${_T_M_P_D_I_R-
  369.          /_v_a_r/_t_m_p}/_p_m_l_a_u_n_c_h._t_r_a_c_e by default).
  370.  
  371.      2.  If the environment variable PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH____TTTTRRRRAAAACCCCEEEE is set, then summary
  372.          information is produced for each ``launch'' operation.
  373.  
  374.      3.  If the environment variable PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH____DDDDUUUUMMMMPPPP is set, then the contents
  375.          of various temporary files used in each ``launch'' operation are
  376.          reported.
  377.  
  378.      The launching of a tool can be prevented by setting PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH____CCCCHHHHEEEECCCCKKKK in the
  379.      environment.
  380.  
  381. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  382.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmddddbbbbgggg(1), ppppmmmmggggaaaaddddggggeeeettttssss(1), ppppmmmmggggssssyyyyssss(1), ppppmmmmssssoooocccckkkkssss(1),
  383.      ppppmmmmvvvvaaaallll(1), ppppmmmmvvvviiiieeeewwww(1), xxxxccccoooonnnnffffiiiirrrrmmmm(1) and PPPPMMMMAAAAPPPPIIII(3).
  384.  
  385. BBBBUUUUGGGGSSSS
  386.      Future versions may allow a hierarchical representation of groups, so
  387.      that groups could contain other groups.
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))                                                        PPPPMMMMLLLLAAAAUUUUNNNNCCCCHHHH((((5555))))
  401.  
  402.  
  403.  
  404.      ccccsssshhhh(1) aliases in the user's environment are ignored by most launch
  405.      scripts which determine the path to the target executable using the sssshhhh(1)
  406.      ttttyyyyppppeeee command.
  407.  
  408. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  409.      Error messages produced by any ppppmmmmllllaaaauuuunnnncccchhhh scripts should be self-
  410.      explanatory.  These messages will be displayed in an xxxxccccoooonnnnffffiiiirrrrmmmm(1) window
  411.      if DDDDIIIISSSSPPPPLLLLAAAAYYYY is set and PPPPCCCCPPPP____SSSSTTTTDDDDEEEERRRRRRRR is set to ``DISPLAY'' in the environment
  412.      (refer to PPPPMMMMAAAAPPPPIIII(3) for a detailed explanation of this environment
  413.      variable).
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.